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Do you still have old DOS-Programs based on CA-Clipper ( -> 

httpy/en.wkipedia.or^wki/Clipper_fprogramrning_language)') running on your system? This Howto shows you, how to 
speed up those programs by compiling them with hmg. 



The Problem 

Since the introduction of Windows XP, you probably get a 1 00% CPU- Usage as soon as you start your r otwmsiartwg — i 
exe. 

Even if your application is only waiting for user- input, it keeps your computer busy. 

I can not fully explain the reason. But Clipper was not designed to be run in a multitasking environment and 
windows goes through great trouble to emulate a DOS -environment. So now as soon as your old program 
runs, even the fastest core duo system slows down to a creep. If you run it on a laptop, your batteries are empty quicker than 
you can say uncle. 



Solution: Compile a Windows-friendly exe 

But it does not have to be this way. 

If you still have your source-code, you are kicky. You can compile it almost without any changes and turn it into an 
application that looks exactly the same, but runs much quicker and consumes only CPU- cycles when it is doing something. 



There are many Clipper compilers out there. Some of them are even free. 



The compiler: Harbour 




Harbour ( -> httpy/www.harbour-proiect.org) is a great compiler. It will take your 
Clipper source-code and turn it into C-Code that can be compiled into a binary. You 
can choose your compiler and there are many libraries that add functions to your 
program you never dreamt of It will even run on Linux and Mac-OS. 



HMG: A harbour-compiler with batteries included 



If you are not interested in Linux and Mac-OS and all the fancy features, you just want an application 
that installs everything you need. A C-Compiler, binaries and batch files and even a lot of samples. 

Such a program exists. It is called "Harbour MiniGUI", or just "hmg" for short. Visit the developers 
website: 




httpy/harbourrninigui.googlepages.conV ( -> httpy/harbourminigui.googlepages,corr/) 



You can grab the latest version here: 
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httpy/www.hmgforum.com/site/ ( -> http://www.hmgforumcom/siteA) 



At the time of writing this post, 3.0.22 is the latest version. It is a 20 MB download. Users at hmgforum.com ( -> 
http://hmgtbrum.com) confirm that it runs well with Windows Vista and Windows 7. 

Update: Right now, the current stable version is 3.0.39 if you don't need postgresql-suppprt. 

hmg 4.0 ist still in alpha-state. It's goal is to port the windows-api based gui to Qt and make it platform- independent. Be 
patient. It is not ready, yet. 



Installing HMG 

After you downloaded, the setup file, you can run a regular installer. 
I recommend installing it into c:\hmg 



W Setup - HMG 3.0.22 (Stable) 



JnJxj 



Select Destination Location 

Where should HMG 3.0.22 (Stable) be installed? 




Setup 



will install HMG 3.0.22 (Stable) into the following folder. 



To continue, click Newt. If you would like to select a different folder, click Browse. 
|CAhmc| 



Browse.. 




At least 1 60,4 MB of free disk space is required. 



< Back | Newt > | Cancel 



Setup - HMG 3.0.22 (Stable) 



Select Start Menu Folder 

"Wheae should S elup place ihe program's shortcuts? 



.Jrjx] 




fj| Setup create Uie program's shortcuts h (tie following Start Menu foUei. 
To fconlinuer. cSek N*Kt. If you would fike to select a dSffeiem folds, drok Browse. 



Browe.,. 



t Back Nem > C«ic*l 



Starting the IDE 

The installation takes a few seconds. After it is finished, you have everthing you need. Compiler, Linker, Include-Files, etc. 



http://raumi75.ji mdo.com/201 0/02/27/fronr>ca-clipper-to-windo\/\/s-in-5-minutes/ 2/12 



2/21/2014 



From CA-Clipper to Windows in 5 Minutes - raumi75 



You could compile your prg- files on the command- line, but I prefer the graphical IDE. It gives you a glipse into the many 
additional features you get with HMG. 

Launch the hmg- ide either from the shortcut on your desktop or the startmenu. 



I IMG -IDE (c) Roberta Lopcc - httas/Vhai 



irminigui.gccglepagcs.caTii - FREEWARE - Vcriicm; 20 1 
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The hmg- ide 

Start a new Project. 



■ HMG-IDE (c) Roberto Lop] 
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£ar Open Project F2 
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£j" Close Project 
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You can place the project into your existing source-code directory on your harddrive. Make sure, you have a copy in case 
anything goes wrong. 



The IDE creates a new "MainPrg" and a new emty form "Main.Fmg". 
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Removing Main.Prg and Main.Fmg 

HMG is a great tool to build real Windows- Applications. It is abolutely amazingly simple to turn an existing Clipper-Program 
into a Windows- Program. But for now, we resist the urge to look at all the shiny features. 



All we want to do is compile our console application. 



So for now, we don't need the Main.Fmg and Main.Prg. Delete them by selecting them in the Project- Browser and clicking 
Project - Delete File from the Menu. 



Adding your Source-Code to the IDE 

Now you have an empty Project. Choose 'Modules" in the Project Browser and click on 'Project" - "Import File" in the 
Menu to import your all your prg- files. 

The first one you choose will be your main- module. That means, it includes the procedure or function that starts the program 
You can declare a module as main by clicking 'Project" - "Set Module As Main" in the menu. 

Console mode 

By default, HMG wants to build a Windows- Application. But your old CA-Clipper-code is a console application. 

So you have to tell the compiler to run in "Console Mode". You do that in the Project Browser in the Configuration- Tab. 
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Project Browser [test.hbp] 


Modules | Foims 


Resources 


Reports Coriligjraliori 


Includes | Tables j 


Include paths: 




Library paths: 




Additional libs: 




■■Console mode' T >H 


Mulli-thread: .F. 




Copy target to: 





Update: If you are using Version 3.0.39, there is noc "Console mode" anymore in the "Configuration"- Tab. Don't panik. It 
still works. Simply add this line to your main .prg-file: 

REQUEST HB_GT_WIN_DEFAULT 

To be more precise, you now have a mixed-mode program That means, you can already use windows- gui elements 
wherever you like. 



Edit your Code 

In some cases, you have to make little adjustments to your code. 

Most importantly, harbour looks for a function or procedure "Main". If it does not find it, it will not do anything, because it 
does not know where to start. 

Clipper also supported the first function to be named like the .prg-file. So open your prg-file with an editor of your choice and 
rename the main liinction. 

The old prg-file will be saved in the codepage 850. 

My favorite editor is iEdit ( -> http://www.iedit.org/) . It calls the codepage IBM850. If some characters (umlauts, accents, 
box-drawing-characters, etc.) look funny, click "File" - "Reload with Encoding" - 'T6M850". 

Do not change the encoding. Keep it 850 for your console application! 



Run 

Compile your code by clicking "Project" - "Run" in the Menu. 

HMG will build an .exe-file and launch it. So if all goes well your program starts. 

The new exe-File is rather large (1-2 MB) compared to an original clipper-exe. But who cares nowadays, right? 

Here is a screenshot of a sample console application. As you can see, the wait-command does not keep the Processor busy. 
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Conclusion 

This howto demonstrated, that you don't have to through away your old Clipper code and write it in a new language if you 
want an application that works well on Windows. 

With hmg you can turn it into a modern harbour- console-program for windows within a tew minutes. 



What next? 

You can now incrementally modernize your program You might mant to start by replacing ALERT() with msgbox() to see 
how well it mixes. 

HMG opens a lot of possibilities to really take old application to the 2 1 st century. 

I find it very impressive, that Roberto Lopez managed to extend the xBase Language, so that modern GUI-Controls can be 
defined in an easy to understand way. 

Code looks like this: 



#include "minigui.ch" 

Function Main 

DEFINE WINDOW Win_l ; 
AT 0,0 ; 
WIDTH 400 ; 
HEIGHT 200 ; 

TITLE 'Tutor 1 0 - Picture Button Test' ; 
MAIN 

@ 10,10 BUTTON PictureButton.l ; 
PICTURE 'button.bmp' ; 
ACTION MsglnfofPicture Button Clicked!!') ; 
WIDTH 27 ; 
HEIGHT 27 ; 
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TOOLTIP 'Picture Button Tooltip' 

END WINDOW 

ACTIVATE WINDOW Win_l 

Return 

The IDE helps you build this code by designing your forms in a gui- designer. 

If you want to know more about HMG, take a look at C:\hmg\SAMPLES and e:\hmg\DOC\hmgdoc.htm (also available 
online ( -> httpy/www.hmgfonimxorrVhmgdoc/hmgdoc.htrn^ ), 

I found the people over at hmgforum.com ( -> http://lmgforum.com) very nice and helpful. They helped me when I got stuck 
and reading the forum gives a lot of insights. 

Comments: 32 Write a comment (-> #) 

Hitman #1 

(Monday, 22 March2010 08:28) 
Nice Info! 

Micsa #2 

(Sunday, 02 May 2010 23:30) 
nice info thanks 

edis #3 

(Sunday, 05 September 2010 16:42) 

Processor abuse problem was well known and fixed in late Clipper, problem only if you miss source code, 
perhaps. 

Even though DOS is heading into nowhere, Clipper had advantage to the very late of providing great base for 
flexible programming, as opposed to much more complicated programming for Windows platform And 
relational data access level is still outstanding, making well questionable superiority of SQL. It may be 
personal, but with demise of Clipper I never had later in hands programming tool, that would match it in 
productivity, versatility. And there were quite some to work with. 

BicahiEsgici #4 

(Wednesday, 26 October 201 1 23:41) 
Hi Ricci 

Could you allow me to publishing this very good article in my blog ? 

By noticing the source of course. 

Regards 

raumi75 ( -> http://raumi75.jimdo.com/) #5 

(Thursday, 27 October 2011 09:50) 
Yes, of course! 

I assume your blog is waclipper, right? Your blog was an important resource for me, when I was looking for a 
way to keep my clipper- program alive. I would appreciate it, if you linked back to this article. 



BicahiEsgici #6 

(Thursday, 27 October 201 1 12:58) 
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Thanks Raumi 

First, sorry for name confusion; 
second, thanks to your kind words :) 

Due to some obscure reasons ( in short, "Google pages" is prohibited in my country) my VivaClipper Google 
page is out of my access :( 

Now I'm struggling move my page to another page. I'm in the beginning and I have too many thing to work on. 
It's not announced yet. 

Pleas look at copy of your article: 

httpy/vivaclipper.wordpress.corn/2011/10/26/from-ca-clipper-to-windows-in-5-minutes/ 

If you like it please notify me your approwal 

Regards 



Esgici 

Bicahi Esgici #7 

(Thursday, 27 October 201 1 13:22) 

In addition; sorry, but I don't understand the "CA-Clipper" term or "Cl*pper" notation. IMO, CA is only 
owner of Clipper compiler, not Clipper language. 

What is your opinion ? 

Regards 



Esgici 

raumi75 ( -> http://raurm75.jimdo.com/) #8 

(Thursday, 27 October 20 1 1 1 8:09) 

It's great to hear that you are building a new site dedicated to clipper. Let's hope they don't start censoring 
wordpress. 

raumi75 ( -> http://raurm75.jimdo.com/) #9 

(Thursday, 27 October 201 1 18:12) 

I am not really happy with the whole naming- issue. "Clipper" and "harbour" are too generic. If you google it, 
you get all kinds of results. For Search- Engine-Optimization- Reasons, I chose to call it CA-Clipper in this 
article as I am trying to address people who still use the old Compiler. 



raumi75 ( -> http://raumi75.jimdo.com/) #10 

(Thursday, 27 October 201 1 18:34) 
So you can't access httpy/sites.google.com / site/vivaclipper2/ any more? I just made a mirror by running "wget 
-m" and zipped it. It is 3,4 MB. Do you want me to mail it to you? 

Bicahi Esgici #11 

(Thursday, 27 October 201 1 2022) 

You are right in naming- issue. Perhaps I think such way because I hate CA ;) 
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Thanks to your proposal about zipped file of my "site"; I have all necessary materials, including zipped full site. 

By the way, you don't noticed your approval on publishing your article; did you seen, and like? 

Regards 

Esgici 



m raumi75 ( -> http://raumi75.jimdo.eom/t #12 

(Thursday, 27 October 201 1 21:35) 

I posted my approval on your blog. Of course you can use the article. 



Esgici #13 

(Saturday, 29 October 201 1 1209) 
Yes, I seen an answered 

Thanks again 

I'm waiting your further supports to xBase community. 



esgici #14 

(Monday, 31 October 2011 20:28) 
HiRaumi 

1 changed URL of your article on my blog: 
http^/vivaclipper.wordpress.conVcategory/clipper/articles/ 

And instead of duplicate, I published it as a summary and added whole address in your blog. 

IMHO with this way no need to you notify me about modifications and to me re- copying or correcting my 
copy. 

What is your opinion ? 



X raumi75 ( -> http://raumi75.jimdo.comA) #15 
(Tuesday, 01 November 2011 19:17) 

1 think, this makes it easier to maintain, when I feel like I have to update something. Thanks for linking here. 



Esgici #16 

(Tuesday, 01 November 201 1 22:41) 
Thanks 

Have you see this post : 

httpy/hrr^rumcom/viewtopic.php?f=19&t=2135#pl8313 
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raumi75 ( -> http://raumi75.jimdo.com/) #17 

(Wednesday, 02 November 201 1) 

Wow, hmgforum links to my blog. I feel flattered. Thanks for telling me. 



Esgici #18 

(Wednesday, 02 November 20 11 18:06) 
You have furthermore : 

http ://hmgforumcom/viewtopic.php?f= 1 9&t=2 1 3 5&start= 1 0 
Congrats 1 



iliev ( -> http://www.google.com) #19 

(Tuesday, 10 January 2012 18:46) 

sorry, but don"e execute module dos/clipper with dows 7 / 64 bitswin 



raumi75 #20 

(Thursday, 12 January 2012 18:33) 

I use Win 7 64 Bit and it runs well What hmg- version did you use? Did you include REQ UEST 
HBGTWINDEFAULT in your .prg file? 



Ghost ship #21 

(Thursday, 12 April2012 18:23) 

Great post! Thank you. While 1 was reading, was traveling about twenty years ago, when 1 had my first 
contact with prograrnming, via Clipper and dBase. What good memories! 



Eduardo Pintado ( -> http://edu.pin2007@gmail.com) #22 

(Wednesday, 25 April 20 12 18:57) 

Great to know there's a chance to upgrade my DOS CA Clipper system 

Q: Can be the new .exe binaries executed straight from Windows or should be triggered thru the IDE ? Many 
thanks 



raumi75 ( -> http://raumi75.jimdo.com/) #23 

(Thursday, 26 April 2012 1 1:41) 

HMG will create an .exe file that runs on Windows. You do not need the IDE to run the binary. 



KM LASH ( -> http://kothari _all@hotmail.com) #24 

(Thursday, 10 May 2012 13:55) 

I was trying to convert my clipper 5.2 app. 

Just after opening screen, I am getting an error 

"dbcmd/2001 workarea not in use DBCLEARFILTER. can u please help? Also, where to find error codes 
list? Thanks. 



raumi75 ( -> http://raumi75.jimdo.com/) #25 

(Thursday, 10 May 20 12 17:09) 

Do you mean after compiling and running your new .exe? That would be a runtime error. Hard to tell what is 
causing it without looking at your code. Have you placed the .exe file into the same directory as your old, 
working .exe? Maybe this post will help you: 



h1ttp^/www.hmgforum.conyviewtopic.php?f=5&t=2 1 69 



The people at hmgforum are very friendly and helpful. There is also a Mailing List 
(http://groups.google.com/group/harbour-users/) and a Facebook group 
(https^/www.facebook.com/groups/harbour.projecty) where you can ask questions. 
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Boban #26 

(Monday, 18 February 2013 22:29) 

Hi, I amusing HMG to convert my old ca-clipper apps to windows gui apps. I want to know how to define 
window for each procedure; in the procedure itself, or to call the procedure when windows initializes? 



raumi75 ( -> http://raumi75.jimdo.com/) #27 

(Tuesday, 19 February 20 13 10:13) 

Hi, 1 am not sure I understand your question. A good start is looking at the many samples in your HMG- folder. 
1 good place to ask such questions is hmgforum.com. The people are very knowledgable, helpful and friendly. 

Nick #28 

(Saturday, 20 April 2013 09:12) 

Hello, I've converted my old Clipper 5.1 app into Harbour using HMG. I can run now my app, my problem is 
that when I type in data, the screen scrolls up line by line with every data I input, so I don't see anymore the 
already typed in data. I use classic contruction lines. 
@ row, col say 'Type in data: ' get somedata 
read 

Any ideas'? Thank you. 



Tim ODell ( -> http://nwtechmcalservices.com) #29 

(Thursday, 13 June 2013 06:42) 

I've installed version 3 . 1 .3 on both Windows 7 and Windows XP, and cannot find an icon for the MiniGui 

program. Which program to start it, and which directory is it in? 

—Thanks 

PS: I agree completely about newer programs being difficult. I'm still maintaining programs from th 80's that 
clients love! 



X raumi75 ( -> http://raumi75.jimdo.com/) #30 
(Wednesday, 19 June 2013 12:51) 

Depending on the path you declared at installation time, it should be c:\hmg.3. 1.3\ide\ide.exe 



wait #31 

(Thursday, 30 January 2014 23:02) 

is there anything that can be done if I don't have the source code 



raumi75 ( -> http://rauiiii75.jimdo.com/) #32 

(Tuesday, 04 February 2014 10:53) 

You will need a decompiler. I have no experience with them Try to google that. You might want to try and ask 
people in the hmg-forum.com or the official harbour mailing list. 



(->) 
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Entry: 
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